home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / PROGEDIT / 1435B.ZIP / JOVE.MAN < prev    next >
Text File  |  1988-02-26  |  15KB  |  397 lines
  1.  
  2.  
  3.  
  4. JOVE(1)             UNIX Programmer's Manual              JOVE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      jove - an interactive display-oriented text editor
  10.  
  11. SYNOPSIS
  12.      jove [-d directory] [-w] [-t tag] [+n file] [-p file] [files]
  13.      jove -r
  14.  
  15. DESCRIPTION
  16.      JOVE is Jonathan's Own Version of Emacs.  It is based on the
  17.      original  EMACS  editor  written at MIT by Richard Stallman.
  18.      Although JOVE is meant to be compatible  with  EMACS,  there
  19.      are  some  major differences between the two editors and you
  20.      shouldn't rely on their behaving identically.
  21.  
  22.      JOVE works  on  any  reasonable  display  terminal  that  is
  23.      described  in  the  _t_e_r_m_c_a_p  file  (see  TERMCAP(5) for more
  24.      details).  When you start up JOVE, it checks to see  whether
  25.      you  have  your _T_E_R_M environment variable set.  On most sys-
  26.      tems that will automatically be set up for you, but if  it's
  27.      not  JOVE  will ask you what kind of terminal you are using.
  28.      To avoid having to type this every time you run JOVE you can
  29.      set  your  _T_E_R_M  environment  variable yourself.  How you do
  30.      this depends on which shell you are  running.   If  you  are
  31.      running the C Shell, as most of you are, you type
  32.  
  33.           % setenv TERM _t_y_p_e
  34.  
  35.      and with the Bourne Shell, you type
  36.  
  37.           $ TERM= _t_y_p_e ; export TERM
  38.  
  39.      where _t_y_p_e is the name of the kind of terminal you are using
  40.      (e.g.,  vt100).   If  neither of these works get somebody to
  41.      help you.
  42.  
  43. INVOKING JOVE
  44.      If you run JOVE with no arguments you will be placed  in  an
  45.      empty buffer, called _M_a_i_n. Otherwise, any arguments you sup-
  46.      ply are considered file names and each is  "given"  its  own
  47.      buffer.   Only  the  first file is actually read in--reading
  48.      other files is deferred until you actually try  to  use  the
  49.      buffers  they  are  attached  to.   This is for efficiency's
  50.      sake: most of the time, when you run JOVE on a big  list  of
  51.      files, you end up editing only a few of them.
  52.  
  53.      The names of all of the files specified on the command  line
  54.      are  saved in a buffer, called *_m_i_n_i_b_u_f*. The mini-buffer is
  55.      a special JOVE buffer that is used when  JOVE  is  prompting
  56.      for  some  input to many commands (for example, when JOVE is
  57.      prompting for a file name).  When you are being prompted for
  58.      a  file name, you can type C-N (that's Control-N) and C-P to
  59.      cycle through the list of files that were specified  on  the
  60.  
  61.  
  62.  
  63. Printed 2/24/88         12 February 1986                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOVE(1)             UNIX Programmer's Manual              JOVE(1)
  71.  
  72.  
  73.  
  74.      command  line.  The file name will be inserted where you are
  75.      typing and then you can edit it as if you typed it in  your-
  76.      self.
  77.  
  78.      JOVE recognizes the following switches:
  79.  
  80.      -_d   The following argument is taken to be the name  of  the
  81.           current directory.  This is for systems that don't have
  82.           a version of C shell that automatically  maintains  the
  83.           _C_W_D  environment variable.  If -_d is not specified on a
  84.           system without a modified C shell, JOVE  will  have  to
  85.           figure  out  the current directory itself, and that can
  86.           be VERY slow.  You can simulate the modified C shell by
  87.           putting the following lines in your C shell initializa-
  88.           tion file (.cshrc):
  89.  
  90.                alias cd        'cd \!*; setenv CWD $cwd'
  91.                alias popd      'popd \!*; setenv CWD $cwd'
  92.                alias pushd     'pushd \!*; setenv CWD $cwd'
  93.  
  94.      +_n   Reads the file, designated by the  following  argument,
  95.           and  positions  point  at  the _n'_t_h line instead of the
  96.           (default) 1'st line.  This can be specified  more  than
  97.           once  but  it doesn't make sense to use it twice on the
  98.           same file; in that case the second one wins.
  99.  
  100.      -_p   Parses the error messages in the file designated by the
  101.           following  argument.  The error messages are assumed to
  102.           be in a format similar to the C compiler, LINT, or GREP
  103.           output.
  104.  
  105.      -_t   Runs the _f_i_n_d-_t_a_g command  on  the  following  argument
  106.           (see ctags(1)).
  107.  
  108.      -_w   Divides the window in two.  When this  happens,  either
  109.           the  same  file  is  displayed  in both windows, or the
  110.           second file in the list is read in and displayed in its
  111.           window.
  112.  
  113. RECOVERING BUFFERS AFTER A CRASH
  114.      The -_r option of jove runs the JOVE  recover  program.   Use
  115.      this  when  the  system  crashes,  or  JOVE  crashes, or you
  116.      accidently get logged out while in JOVE.  If there  are  any
  117.      buffers to be recovered, this will find them.
  118.  
  119.      Recover looks for JOVE buffers that are left around and  are
  120.      owned  by  you.  (You cannot recover other peoples' buffers,
  121.      obviously.) If there were no buffers that were  modified  at
  122.      the  time  of  the crash or there were but recover can't get
  123.      its hands on them, you will be informed  with  the  message,
  124.      "There  is  nothing  to recover."  Otherwise, recover prints
  125.      the date and time of the version of the buffers it has,  and
  126.  
  127.  
  128.  
  129. Printed 2/24/88         12 February 1986                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. JOVE(1)             UNIX Programmer's Manual              JOVE(1)
  137.  
  138.  
  139.  
  140.      then waits for you type a command.
  141.  
  142.      To get a list of the buffers recover knows  about,  use  the
  143.      _l_i_s_t  command.  This will list all the buffers and the files
  144.      and the number of lines associated with them.  Next to  each
  145.      buffer  is a number.  When you want to recover a buffer, use
  146.      the _g_e_t command.  The syntax is _g_e_t  _b_u_f_f_e_r  _f_i_l_e_n_a_m_e  where
  147.      _b_u_f_f_e_r  is  either  the  buffer's  name or the number at the
  148.      beginning of the line.  If you don't type the buffer name or
  149.      the filename, recover will prompt you for them.
  150.  
  151.      If there are a lot of buffers and you want to recover all of
  152.      them,  use  the  _r_e_c_o_v_e_r  command.   This  will recover each
  153.      buffer to the name of the buffer with ".#" prepended to  the
  154.      name (so that the original isn't over-written).  It asks for
  155.      each file and if you want to restore  that  buffer  to  that
  156.      name you type "yes".  If you want to recover the file but to
  157.      a different name, just type the new name in.   If  you  type
  158.      "no" recover will skip that file and go on to the next one.
  159.  
  160.      If you want to look at a buffer before deciding  to  recover
  161.      it,  use  the  _p_r_i_n_t  command.  The syntax for this is _p_r_i_n_t
  162.      _b_u_f_f_e_r where _b_u_f_f_e_r again is either its name or the  number.
  163.      You  can  type  ^C if you want to abort printing the file to
  164.      the terminal, and recover will respond with  an  appropriate
  165.      message.
  166.  
  167.      When you're done and have all the buffers you want, type the
  168.      _q_u_i_t  command to leave.  You will then be asked whether it's
  169.      okay to delete the tmp files.  Most of the time that's  okay
  170.      and  you should type "yes".  When you say that, JOVE removes
  171.      all traces of those buffers and you won't be able to look at
  172.      them  again.  (If you recovered some buffers they will still
  173.      be around, so don't worry.)  So, if you're not sure  whether
  174.      you've  gotten  all  the  buffers, you should answer "no" so
  175.      that you'll be able to run recover again  at  a  later  time
  176.      (presumably  after you've figured out which ones you want to
  177.      save).
  178.  
  179.      If you type ^C at any time other than when you're printing a
  180.      file  to the terminal, recover will exit without a word.  If
  181.      you do this but wish you hadn't, just type "jove -r" to  the
  182.      shell again, and you will be put back with no loss.
  183.  
  184. GETTING HELP
  185.      Once in JOVE, there are several commands  available  to  get
  186.      help.   To  execute  any  JOVE  command,  you  type "<ESC> X
  187.      command-name" followed by <Return>.  To get a  list  of  all
  188.      the  JOVE  commands you type "<ESC> X" followed by "?".  The
  189.      _d_e_s_c_r_i_b_e-_b_i_n_d_i_n_g_s command can be used to get a list contain-
  190.      ing  each key, and its associated command (that is, the com-
  191.      mand that gets executed when you type  that  key).   If  you
  192.  
  193.  
  194.  
  195. Printed 2/24/88         12 February 1986                        3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. JOVE(1)             UNIX Programmer's Manual              JOVE(1)
  203.  
  204.  
  205.  
  206.      want  to  save  the  list  of bindings, you can set the jove
  207.      variable _s_e_n_d-_t_y_p_e_o_u_t-_t_o-_b_u_f_f_e_r to ON (using  the  _s_e_t  com-
  208.      mand), and then execute the _d_e_s_c_r_i_b_e-_b_i_n_d_i_n_g_s command.  This
  209.      will create a buffer and put in it the bindings list it nor-
  210.      mally  would  have printed on the screen.  Then you can save
  211.      that buffer to a file and print it to use as a quick  refer-
  212.      ence card.  (See VARIABLES below.)
  213.  
  214.      Once you know the name of a command, you can find  out  what
  215.      it  does  with  the  _d_e_s_c_r_i_b_e-_c_o_m_m_a_n_d command, which you can
  216.      invoke quickly by typing "ESC ?".  The _a_p_r_o_p_o_s command  will
  217.      give you a list of all the command with a specific string in
  218.      their names.  For example, if you want to know the names  of
  219.      all  the  commands  that are concerned with windows, you can
  220.      run "apropos" with the keyword _w_i_n_d_o_w.
  221.  
  222.      If you're not familar with the EMACS command set,  it  would
  223.      be  worth your while to use run TEACHJOVE.  Do do that, just
  224.      type "teachjove" to your shell and you  will  be  placed  in
  225.      JOVE  in  a file which contains directions.  I highly recom-
  226.      mend this for beginners; you may save yourself a lot of time
  227.      and headaches.
  228.  
  229. KEY BINDINGS and VARIABLES
  230.      You can alter the key bindings in JOVE to fit your  personal
  231.      tastes.   That is, you can change what a key does every time
  232.      you strike it.  For example, by default the C-N key is bound
  233.      to  the  command  _n_e_x_t-_l_i_n_e and so when you type it you move
  234.      down a line.  If you want to change a binding or add  a  new
  235.      one,  you use the _b_i_n_d-_t_o-_k_e_y command.  The syntax is "bind-
  236.      to-key <command> key".
  237.  
  238.      You can also change the way JOVE behaves in little  ways  by
  239.      changing  the  value of some variables with the _s_e_t command.
  240.      The syntax is "set  <variable>  value",  where  value  is  a
  241.      number  or a string, or "on" or "off", depending on the con-
  242.      text.  For example, if you want JOVE to make  backup  files,
  243.      you  set  the  "make-backup-files" variable to "on".  To see
  244.      the value of a variable, use the "print <variable>" command.
  245.  
  246. INITIALIZATION
  247.      JOVE automatically reads  commands  from  an  initialization
  248.      file in your HOME directory, called ".joverc".  In this file
  249.      you can place commands that you would normally type in JOVE.
  250.      If you like to rearrange the key bindings and set some vari-
  251.      ables every time you get into JOVE, you should put  them  in
  252.      your initialization file.  Here are a few lines from mine:
  253.           set match-regular-expressions on
  254.           auto-execute-command auto-fill /tmp/Re\|.*drft
  255.           bind-to-key i-search-forward ^\
  256.           bind-to-key i-search-reverse ^R
  257.           bind-to-key find-tag-at-point ^[^T
  258.  
  259.  
  260.  
  261. Printed 2/24/88         12 February 1986                        4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. JOVE(1)             UNIX Programmer's Manual              JOVE(1)
  269.  
  270.  
  271.  
  272.           bind-to-key scroll-down ^C
  273.           bind-to-key grow-window ^Xg
  274.           bind-to-key shrink-window ^Xs
  275.      (Note that the Control Characters can be either two  charac-
  276.      ter  sequences  (e.g.  ^ and C together as ^C) or the actual
  277.      control character.  If you want to use an ^  by  itself  you
  278.      must  BackSlash it (e.g., bind-to-key grow-window ^X\^ binds
  279.      grow-window to "^X^").
  280.  
  281. SOME MINOR DETAILS
  282.      You should type C-\ instead of C-S in many  instances.   For
  283.      example,  the  way  to  search for a string is documented as
  284.      being "C-S" but in reality you should type "C-\".   This  is
  285.      because  C-S  is the XOFF character (what gets sent when you
  286.      type the NO SCROLL key), and clearly that won't  work.   The
  287.      XON  character  is  "C-Q"  (what  gets sent when you type NO
  288.      SCROLL again) which  is  documented  as  the  way  to  do  a
  289.      quoted-insert.   The  alternate key for this is "C-^" (typed
  290.      as "C-`" on vt100's and its look-alikes).  If  you  want  to
  291.      enable  C-S and C-Q and you know what you are doing, you can
  292.      put the line:
  293.           set allow-^S-and-^Q on
  294.      in your initialization file.
  295.  
  296.      If your terminal has a metakey, JOVE will use it if you turn
  297.      on the "meta-key" variable.  JOVE will automatically turn on
  298.      "meta-key" if the METAKEY environment variable exists.  This
  299.      is  useful for if you have different terminals (e.g., one at
  300.      home and one at work) and one has a metakey  and  the  other
  301.      doesn't.
  302.  
  303. FILES
  304.      LIBDIR/.joverc - system wide initialization file
  305.      ~/.joverc - personal initialization file
  306.      TMPDIR - where temporary files are stored
  307.      LIBDIR/teach-jove - the interactive tutorial
  308.      LIBDIR/portsrv - for running shells in windows (pdp11 only)
  309.  
  310. SEE ALSO
  311.      ed(1) - for a description of regular expressions
  312.      teachjove(1) - for an interactive JOVE tutorial.
  313.  
  314. DIAGNOSTICS
  315.      JOVE diagnostics are meant to be self-explanatory,  but  you
  316.      are advised to seek help whenever you are confused.  You can
  317.      easily lose a lot of work if you don't know EXACTLY what you
  318.      are doing.
  319.  
  320. BUGS
  321.      Lines can't be more than 1024 characters long.
  322.  
  323.      Searches can't cross line boundaries.
  324.  
  325.  
  326.  
  327. Printed 2/24/88         12 February 1986                        5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. JOVE(1)             UNIX Programmer's Manual              JOVE(1)
  335.  
  336.  
  337.  
  338. AUTHOR
  339.      Jonathan Payne
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393. Printed 2/24/88         12 February 1986                        6
  394.  
  395.  
  396.  
  397.